
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<HTML>

<HEAD>
   <TITLE>reclat_c</TITLE>
</HEAD>

<BODY style="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<A name="TOP"></A>

<table style="text-align: left; margin-left: auto; margin-right: auto; width: 800px;"
 border="0" cellpadding="5" cellspacing="2">
  <tbody>
    <tr>
      <td style="background-color: rgb(153, 153, 153); vertical-align: middle; text-align: center;">
      <div align="right"> 
      <small><small><a href="index.html">Index Page</a></small></small>
      </div>
      <b>reclat_c</b> </td>
    </tr>

    <tr>
      <td style="vertical-align: top;">

<small><div align="center">
<A HREF="index.html#A">A</A>&nbsp;
<A HREF="index.html#B">B</A>&nbsp;
<A HREF="index.html#C">C</A>&nbsp;
<A HREF="index.html#D">D</A>&nbsp;
<A HREF="index.html#E">E</A>&nbsp;
<A HREF="index.html#F">F</A>&nbsp;
<A HREF="index.html#G">G</A>&nbsp;
<A HREF="index.html#H">H</A>&nbsp;
<A HREF="index.html#I">I</A>&nbsp;
<A HREF="index.html#J">J</A>&nbsp;
<A HREF="index.html#K">K</A>&nbsp;
<A HREF="index.html#L">L</A>&nbsp;
<A HREF="index.html#M">M</A>&nbsp;
<A HREF="index.html#N">N</A>&nbsp;
<A HREF="index.html#O">O</A>&nbsp;
<A HREF="index.html#P">P</A>&nbsp;
<A HREF="index.html#Q">Q</A>&nbsp;
<A HREF="index.html#R">R</A>&nbsp;
<A HREF="index.html#S">S</A>&nbsp;
<A HREF="index.html#T">T</A>&nbsp;
<A HREF="index.html#U">U</A>&nbsp;
<A HREF="index.html#V">V</A>&nbsp;
<A HREF="index.html#W">W</A>&nbsp;
<A HREF="index.html#X">X</A>&nbsp;
</div></small>
       <br>
       <table style="text-align: left; width: 60%; margin-left: auto; margin-right: auto;"
       border="0" cellspacing="2" cellpadding="2">
        <tbody>
          <tr>
            <td style="width: 50%; text-align: center;">
            <small>
              <a href="#Procedure">Procedure<br></a>
              <a href="#Abstract">Abstract<br></a>
              <a href="#Required_Reading">Required_Reading<br></a>
              <a href="#Keywords">Keywords<br></a>
              <a href="#Brief_I/O">Brief_I/O<br></a>
              <a href="#Detailed_Input">Detailed_Input<br></a>

              </small>
              </td>
              <td style="vertical-align: top; width: 50%; text-align: center;">
              <small>               <a href="#Detailed_Output">Detailed_Output<br></a>
              <a href="#Parameters">Parameters<br></a>
              <a href="#Exceptions">Exceptions<br></a>
              <a href="#Files">Files<br></a>
              <a href="#Particulars">Particulars<br></a>
              <a href="#Examples">Examples<br></a>

              </small>
              </td>
              <td style="vertical-align: top; width: 50%; text-align: center;">
              <small>               <a href="#Restrictions">Restrictions<br></a>
              <a href="#Literature_References">Literature_References<br></a>
              <a href="#Author_and_Institution">Author_and_Institution<br></a>
              <a href="#Version">Version<br></a>
              <a href="#Index_Entries">Index_Entries<br></a>
             </small>
            </td>
          </tr>
        </tbody>
</table>

<h4><a name="Procedure">Procedure</a></h4>
<PRE>
   void reclat_c ( ConstSpiceDouble    rectan[3],
                   SpiceDouble       * radius,
                   SpiceDouble       * longitude,
                   SpiceDouble       * latitude  )

</PRE>
<h4><a name="Abstract">Abstract</a></h4>
<PRE>
   Convert from rectangular coordinates to latitudinal coordinates.
 </PRE>
<h4><a name="Required_Reading">Required_Reading</a></h4>
<PRE>
   None.
</PRE>
<h4><a name="Keywords">Keywords</a></h4>
<PRE>
 

   CONVERSION,  COORDINATES


</PRE>
<h4><a name="Brief_I/O">Brief_I/O</a></h4>
<PRE>
 
   VARIABLE  I/O  DESCRIPTION
   --------  ---  --------------------------------------------------
   rectan     I   Rectangular coordinates of a point.
   radius     O   Distance of the point from the origin.
   longitude  O   Longitude of the point in radians.
   latitude   O   Latitude of the point in radians.
 </PRE>
<h4><a name="Detailed_Input">Detailed_Input</a></h4>
<PRE>
 

   rectan     The rectangular coordinates of the input point.  `rectan'
              is a 3-vector.
 </PRE>
<h4><a name="Detailed_Output">Detailed_Output</a></h4>
<PRE>
 
 
   radius     Distance of the point from the origin.

              The units associated with `radius' are those
              associated with the input `rectan'.

   longitude  Longitude of the input point.  This is angle between the
              prime meridian and the meridian containing `rectan'.  The
              direction of increasing longitude is from the +X axis
              towards the +Y axis.
 
              Longitude is output in radians. The range of `longitude'
              is [-pi, pi].


   latitude   Latitude of the input point.  This is the angle from
              the XY plane of the ray from the origin through the
              point. 

              Latitude is output in radians.  The range of `latitude'
              is [-pi/2, pi/2].
</PRE>
<h4><a name="Parameters">Parameters</a></h4>
<PRE>
 
 
   None. 
</PRE>
<h4><a name="Exceptions">Exceptions</a></h4>
<PRE>
 
 
   Error free. 

   1) If the X and Y components of `rectan' are both zero, the
      longitude is set to zero.

   2) If `rectan' is the zero vector, longitude and latitude are
      both set to zero.
 </PRE>
<h4><a name="Files">Files</a></h4>
<PRE>
 

   None. 
 </PRE>
<h4><a name="Particulars">Particulars</a></h4>
<PRE>
 

   None.
</PRE>
<h4><a name="Examples">Examples</a></h4>
<PRE>
   Below are two tables.
 
   Listed in the first table (under rectan[0], rectan[1], and
   rectan[2]) are a number of points whose rectangular coordinates are
   taken from the set {-1, 0, 1}.
 
   The results of the code fragment

      <b>reclat_c</b> ( rectan, &amp;r, &amp;longitude, &amp;latitude );

      latitude  *=  <a href="dpr_c.html">dpr_c</a>();
      longitude *=  <a href="dpr_c.html">dpr_c</a>();

   are listed to four decimal places in the second parallel table under
   r (radius), longitude, and latitude.

   rectan[0]  rectan[1] rectan[2]    r       longitude  latitude
   -------------------------------   ----------------------------
     0.0000     0.0000   0.0000      0.0000    0.0000    0.0000
     1.0000     0.0000   0.0000      1.0000    0.0000    0.0000
     0.0000     1.0000   0.0000      1.0000   90.0000    0.0000
     0.0000     0.0000   1.0000      1.0000    0.0000   90.0000
    -1.0000     0.0000   0.0000      1.0000  180.0000    0.0000
     0.0000    -1.0000   0.0000      1.0000  -90.0000    0.0000
     0.0000     0.0000  -1.0000      1.0000    0.0000  -90.0000
     1.0000     1.0000   0.0000      1.4142   45.0000    0.0000
     1.0000     0.0000   1.0000      1.4142    0.0000   45.0000
     0.0000     1.0000   1.0000      1.4142   90.0000   45.0000
     1.0000     1.0000   1.0000      1.7320   45.0000   35.2643
 </PRE>
<h4><a name="Restrictions">Restrictions</a></h4>
<PRE>
   None.
</PRE>
<h4><a name="Literature_References">Literature_References</a></h4>
<PRE>
   None.
</PRE>
<h4><a name="Author_and_Institution">Author_and_Institution</a></h4>
<PRE>
   N.J. Bachman    (JPL)
   W.L. Taber      (JPL) 
   E.D. Wright     (JPL)
</PRE>
<h4><a name="Version">Version</a></h4>
<PRE>
   -CSPICE Version 1.2.1, 30-JUL-2003 (NJB)

       Various header changes were made to improve clarity.  Some
       minor header corrections were made.

   -CSPICE Version 1.2.0, 28-AUG-2001 (NJB)
     
       Removed tab characters from source file.  Now includes 
       interface macro header SpiceZim.h.

   -CSPICE Version 1.1.0, 21-OCT-1998 (NJB)

      Made input vector const.

   -CSPICE Version 1.0.0, 08-FEB-1998 (EDW)
</PRE>
<h4><a name="Index_Entries">Index_Entries</a></h4>
<PRE>
   rectangular to latitudinal coordinates
</PRE>
<h4>Link to routine reclat_c source file <a href='../../../src/cspice/reclat_c.c'>reclat_c.c</a> </h4>

      </td>
    </tr>
  </tbody>
</table>

   <pre>Wed Jun  9 13:05:28 2010</pre>

</body>
</html>

